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This Technical Note describes some of the more esoteric features of the Video Overlay Card. 



The Video Overlay Card contains a duplicate of the Apple IIgs video circuitry to help 
accomplish its task. This makes some pretty unusual (or esoteric, or downright weird) display 
behavior possible. Although this Note describes these techniques, the APDA document "Apple 
II Video Overlay Card Developers Notes" is considered the Bible of the VOC and should be 
consulted for further details, such as how to make the function calls described in this Note and 
what the constant values are. 



RAM Page Select 

Normally, the Mega II video circuitry on the Apple IIgs looks at bank $E1 (the auxiliary bank on 
Apple He) from $2000 to $9FFF for the Super High-Res graphics display buffer (pixel data, 
scan-line control bytes, and color palettes). This is the default for the VOC, and as such, a 
monitor connected to the VOC displays the same Super High-Res graphics as a monitor 
connected to the Apple IIgs main logic board. 

A feature the VOC card has beyond the Apple IIGS video circuitry is its ability to select between 
bank $E1 (the auxiliary bank on the He) and bank $E0 (main bank on He) for its graphics display 
buffer. By specifying bank $E0 (or main bank on the He) , $E0/2000 to $E0/9FFF becomes the 
display buffer from which the pixel data, scan-line control bytes, and color palettes are found. 

Another added feature of the VOC related to RAM Page Select is its ability to interlace between 
banks $E1 and $E0 (described later in this Note). 

Note: When you select bank $E0 as the graphics display bank, you need to ensure that 
the display buffer memory is linear (remember, the Super High-Res graphics 
display buffer needs to be linear). 



What All Does This Thing Do? 



Technique 
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PASCAL : 

VDGGControl ( VDRAMPageSel , VDAux ) ; {selects Aux bank $E1} 
VDGGControl(VDRAMPageSel,VDMain) ; {selects Main bank $E0} 

VDGGControl (VDMainPageLin, VDEnable ) ; {enable main page $E0 linearization} 
VDGGControl (VDMainPageLin, VDDisable ) ; {disable main page linearization} 

Uses 

• Dual monitors. A monitor connected to the main logic board of the IlGS has its 
display buffer in the normal $E1 bank, while a monitor connected to the VOC has 
its display buffer in bank $E0. 

• Double-buffered graphics. This is the ability to draw graphics in one bank while 
displaying from the other, then switching display banks when appropriate. 



Interlacing 

As mentioned earlier, another added feature of the VOC is its ability to perform 400 line 
interlacing. By enabling interlacing on the VOC, the card displays the even and odd lines from 
different memory areas depending on the setting of the RAM page select. If interlacing is 
enabled and the auxiliary bank is selected (the default at reset), then the VOC displays both the 
even and odd scan lines from bank $E1, giving the same display as if interlacing was not enabled 
at all (the 200 lines from bank $E1 are interlaced with the same 200 lines from bank $E1). If 
interlacing is enabled and the main bank is selected, then the VOC displays both the even and 
odd scan lines from bank $E0 (same sort of thing, the 200 lines from bank $E0 are interlaced 
with the same 200 lines from bank $E0.) 

Now for the useful part, — if interlacing is enabled and RAM Page Select is set to interlace, then 
interlacing occurs between banks $E1 and $E0 (the odd 200 lines come from bank $E1 and the 
even 200 lines come from bank $E0). 

Remember in Super High-Res interlace mode, not only the pixel data but also the scan line 
control bytes and color palettes can be different between the two banks and need to be loaded. 
Also be sure to turn main page linearization on before loading data into the $E0 bank (see 
discussion on RAM Page Select). 

Technique 

PASCAL : 

VDGGControl ( VDRAMPageSel, VDInterlace ) ; {selects interlacing between banks 

$E1 and $E0} 

VDGGControl (VDInterlaceMode, VDEnable ) ; {enables 400 line interlace mode} 
VDGGControl (VDInterlaceMOde, VDDisable ) ; {disables 400 lines interlace mode} 

Uses 

• 400-line display. A monitor connected to the VOC can display 400 different 
lines when interlace is enabled and RAM Page Select is set to interlace. 
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Warning: The technique of interlacing can cause noticeable flicker 
when pixels on adjacent horizontal lines are different. 

Dual Monitors 

Because the VOC has a duplicate of the video circuitry of the Apple IlGS, it has the capability to 
have two monitors displaying the same or totally different information at the same time. The 
VOC doesn't have to be in the same display mode as the main logic board. It can be in the same 
video mode or in a totally different one (i.e., the main logic board is in text mode while the VOC 
is in Super High-Res mode.) 

The technique required for putting the VOC into a video mode different from that of the main 
logic board's circuitry is to enable and disable, at the appropriate time, the bus to the VOC. To 
go into the video mode in which you want the VOC to remain, you must first make sure the bus 
is enabled (power on default). Once you have the VOC in the mode you want, disable the bus 
with VDGGControl ( VDGGBus , VDEnable ) , then go into the video mode in which you 
want the main logic board. After you have the main logic board into the mode you want, 
reenable the bus with VDGGControl (VDGGBus , VDDisable ) . Remember to reenable the 
bus or the VOC screen remains frozen— memory writes to the video display buffers are not 
written through to the VOC's internal memory display buffers. 

Technique 

PASCAL : 

VDGGControl (VDGGBus, VDEnable ) ; {Enables the GGBus_Disable circuitry which 

inhibits writes to the VOC display memory.} 

VDGGControl (VDGGBus, VDDisable ) ; {Disables the GGBus_Disable circuitry which 

enables writes to the VOC display memory 
(power on default)} 

Uses 

• Two monitors with different display modes. A monitor connected to the VOC 
can display one mode while a monitor connected to the main logic board is 
displaying another. There are many different applications that could benefit from 
this type of monitor arrangement. For example, you might need one monitor to 
display control information, while another is displaying graphics (a debugger 
could trace code in text mode on one monitor, while the other monitor is 
displaying the actual graphics in real time.) 

Apple He 

One of the outstanding features of the VOC is its ability to provide all the video modes found on 
the IlGS to the Apple He community, including Super High-Res graphics (320x200 or 640x200 
bit resolution). Not only can Apple He owners experience the world of Super High-Res graphics 
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with the VOC, they also can perform all the previously mentioned functions (such as RAM page 
select, interlacing, and dual monitors). 

Super High-Res graphics mode on the He is enabled the same way as on the IIgs. The New 
Video register, which is located at $C029, is the register which controls the mode. The 
following is a short description of the bits for this register as found in the Apple IlGS Hardware 
Reference: 



Bit 7: Enables old Apple He video modes 

1 Enables Super High-Res video mode 
Bit 6: Memory linearization is disabled (old Apple He memory map 
configuration) 

1 Memory linearization is enabled (memory from $2000 to $9D00 
becomes one linear address space.) 
Bit 5: Double Hi-Res graphics are displayed in color 

1 Double Hi-Res graphics are displayed in black and white 
Bits 4-0: Undefined 



From this description, all that is needed to switch into Super High-Res display mode, is to set 
bits six and seven at memory location $C029. When you want to go back to the old Apple He 
video modes, just clear bits six and seven. 

Note: The Super High-Res graphics display buffer on the Apple He is located in 
Auxiliary memory from $2000 to $9FFF (unless its been changed to Main page 
with RAM page select, as described earlier in this Note). Within this display 
buffer, you must set up the following three types of data: 



$2000-$9CFF Pixel Data 
$9D00-$9DFF Scan-line control bytes 
$9E00-$9FFF Color palettes 

For more details, see the Apple IlGS Hardware Reference. 



Implementation Technique 

The thing to remember is to make sure memory linearization is on ($C029 bit 6=1) before you 
fill the Super High-Res buffer ($2000-$9FFF). If you write a program that moves data into the 
display buffer with memory linearization off ($C029 bit 6=0), then enable Super High-Res by 
turning bits six and seven on, you do not get the results you anticipate. What you see is a 
scrambled mess on the screen, because you filled the display buffer with memory linearization 
off (the VOC filled its display buffer in a nonlinear manner), and when you turned Super High- 
Res mode on, the VOC expected to see memory in a linear manner. 

Apple He Super High-Res Demo Program 

*************************************************************** 
* 

* A simple Apple lie super high res. screen demo load program for 



4 of 6 



Apple II Miscellaneous 
#17: Buried Treasures of the Video Overlay Card 



Developer Technical Support 



September 1990 



* use with the "Apple II Video Overlay Card" 
* 

* Copyright Apple Computer, Inc. 1989 

* All rights reserved. 
* 

* Programmed by: Dan Hitchens May 1989 
* 

**************************************************************** 



This program loads super high res. screen dumped files which 
were named "SCREEN. x" (where x starts at zero and increments 
up sequentially.) When this program doesn't find the next 
sequential file, it beeps and starts looking back at 
"SCREEN. 0" again (this program loops endlessly.) 



longi off 
longa off 
MACHINE M65c02 
ENTRY begin: CODE 



*************************************************************** 



;beep subroutine 

;ProDos-8 machine language interface 
;Aux. move firmware routine 
;0pen command 
;Read command 
; Close command 



begin 


PROC 


BElll 


EQU $FBDD 


ML I 


EQU $BF00 


AuxMove 


EQU $C311 


OpenCMD 


EQU $C8 


ReadCMD 


EQU $CA 


CloseCMD 


EQU $CC 




Ida #$40 




sta $C029 


NextFile 


nop 



;turn on memory linearization 



; First init. a few counters 



Ida #$20 
sta AuxAddr 



;init aux. address counter 



;Now Open the file 

jsr ML I 
dc . b OpenCmd 
dew OpenBlk 
beq 0K0pen2 



; perform an open command 

;passed command (open) 

; passed block address 

; branch if able to open file 



;We arrive here if unable to open the file (probably wasn't there) 



InitZero 



jsr Belli 
Ida #'0' 
sta FileNum-1 
jmp NextFile 



; sound the bell 
;re-init to " SCREEN. 0" 
;init. SCREEN. x to .0 
;go try opening " SCREEN. 0" 



0K0pen2 



Ida ORefNum 
sta RRefNum 
sta CRefNum 



; get ref. num from open command 
; store for read command 
; store for close command 



OKOpen nop 

;Now read $4000 bytes into $3000 
jsr ML I 
dc.b ReadCMD 
dew ReadBlk 
sta MyError 
bes AllDone 



;call machine language interface 

; passed command (read) 

; passed block address 

;save returned error (if any) 

; branch if error occurred 



;Set starting address to $3000 
Ida #0 
sta $3c 
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Ida #$30 
sta $3d 

;Set ending address to $6fff 
Ida #$ff 
sta $3e 
Ida #$6f 
sta $3f 

;Set destination starting addr to AuxAddr (its incremented) 
Ida #0 
sta $42 
Ida AuxAddr 
sta $43 



sec ;to indicate move from main to aux mem. 

jsr AuxMove ;now move the data to aux. memory 

;Now increment AuxAddr : =AuxAddr+$4 000 
Ida AuxAddr 
clc 

adc #$40 
sta AuxAddr 

Ida MyError ; get error (if any) 

beq OKOpen ; continue reading until error (eof) 



;Now we can turn on the super high res screen 
AllDone nop 

Ida #$c0 

sta $c029 
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;Now delay for awhile (just a big delay loop) 
Ida #0 
tax 
tay 

Ida #12 
xloop dex 
nop 
nop 
nop 
nop 
nop 
nop 
nop 
nop 
nop 



yloop 



bne xloop 
dey 

bne xloop 
dec a 
bne xloop 



;Now Close the file 
jsr ML I 
dc.b CloseCmd 
dew CloseBlk 



;do a Close command 

; passed command (close) 

; passed block address 



;Now increment to next file 
Ida FileNum-1 
cmp # ' 9 ' 
beq InitZero 
clc 

adc #1 

sta FileNum-1 
jmp NextFile 



; get current file number 
;is it nine 

; branch if already at nine 
;else add one to next " SCREEN. x" 
;go try and read next file 





STRING PASCAL 


;we want pascal strings 


OpenBlk 


dc .b 


3 






dc.W 


Pathname 






dc.W 


$2700 




ORefNum 


ds.b 


1 


; returned ref_num 


Pathname 


dc.b 


' SCREEN . ' 




FileNum 


ds.b 


1 




ReadBlk 


dc.b 


4 


;no. of parameters 


RRefNum 


ds.b 


1 


;ref. number (stuffed from Open 




dc .w 


$3000 


;data buffer pointer 




dc . w 


$4000 


; request count 




ds . w 


1 


; actual data transferred count 


CloseBlk 


dc.b 


1 


;no. of parameters 


CRefNum 


ds.b 


1 


;ref. number (Stuffed from Open 


AuxAddr 


ds.b 


1 


;aux. address pointer 


MyError 


ds.b 


1 






ENDP 







END 



Further Reference 

• Apple IlGS Hardware Reference 

• Apple II Video Overlay Card Developers Notes (APDA) 
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